home *** CD-ROM | disk | FTP | other *** search
/ Your Choice 3 / Your Choice Software Collection 3.iso / os2 / bootos21 / bootos2.doc < prev    next >
Text File  |  1994-07-13  |  21KB  |  465 lines
  1.                       OS/2 V2 BOOT System Create Utility
  2.                       Copyright IBM Corp.  (C) 1992,1994
  3.                             Program Property of IBM
  4.  
  5. The BOOTOS2 program is a utility that allows you to build a BOOTable OS/2 V2.x
  6. system using an existing OS/2 V2.x system.  The BOOT system can be installed on
  7. either Floppy Disks or a Hard Disk Partition.
  8.  
  9. There are three types of BOOT systems you can install:
  10.  
  11.   Minimal : This is a basic OS/2 V2.x system that supports one or more OS/2
  12.             Full Screen sessions.  All 16 and 32-bit OS/2 Full Screen
  13.             applications are supported.  When installed on a hard disk drive,
  14.             you can use the VDM option to add support for full screen VDM
  15.             sessions.  The ability to switch between different Screen Sessions
  16.             is supported by the supplied Protect Shell program, BOS2SHL.  You
  17.             can switch between Screen Sessions, both OS/2 and VDM, using the
  18.             Alt-Esc key sequence.
  19.  
  20.             A Minimal BOOT system can installed on a single 3.5" 1.44M Floppy
  21.             Disk or to a small (2-3M) hard disk partition.  Installation to a
  22.             single 2.88M floppy disk is also supported.  Because of space
  23.             constraints, it is highly recommended that unless you are
  24.             installing to a 2.88M disk or to a hard disk partition, you use
  25.             the 2DISK option to create a 2-Disk BOOT System.  If your A: drive
  26.             is 5.25" 1.2M, the 2DISK option will be assumed.
  27.  
  28.        PM : This is an OS/2 V2.x system that supports one or more OS/2 Full
  29.             Screen or PM sessions.  If the VDM option is specified, support for
  30.             both Windowed (i.e. Seemless) and Full Screen VDM sessions is
  31.             added.  The ability to switch between different Screen Sessions is
  32.             supported by the supplied Protect Shell program, PMSHELL. You can
  33.             switch between Screen Sessions, both OS/2 and VDM, using the
  34.             Alt-Esc key sequence.
  35.  
  36.             A PM BOOT System requires about 9M of hard disk space.  This does
  37.             not include the disk space needed for the SWAP file.
  38.  
  39.       WPS : This is an OS/2 V2.x system that supports one or more OS/2 Full
  40.             Screen or PM sessions.  If the VDM option is specified, support for
  41.             both Windowed (i.e. Seemless) and Full Screen VDM sessions is
  42.             added.  The ability to switch between different Screen Sessions is
  43.             supported by the supplied Protect Shell program, PMSHELL. You can
  44.             switch between Screen Sessions, both OS/2 and VDM, using the
  45.             Alt-Esc key sequence.  The difference between this and a PM BOOT
  46.             System is the availability of the OS/2 WPS.  Certain default System
  47.             Program and Folder objects are included.
  48.  
  49.             A WPS BOOT System requires about 9M of hard disk space.  This does
  50.             not include the disk space needed for the SWAP file.
  51.  
  52.     Syntax:  BOOTOS2   <SOURCE=drive:\path\>
  53.                        <TARGET=drive>
  54.                        <TYPE=PM|WPS>
  55.                        <NLS(Country,KBD,CodePage)>
  56.                        <2DISK[=drive]>
  57.                        <ABIOS>
  58.                        <REXX>
  59.                        <SWAP=drive:\path\>
  60.                        <TRACE[=drive:\path\file]>
  61.                        <HELP>
  62.                        <SYSED>
  63.                        <VDM>
  64.                        <FORMAT[:FAT]>
  65.                        <FORMAT:HPFS>
  66.                        <FORMAT:NONE>
  67.                        <QUIET>
  68.                        <GA200|SP200|GA210|SP211|MR211>
  69.  
  70.              SOURCE=  Depending on what type of install you ask BOOTOS2 to
  71.                       perform, certain files might be required from the
  72.                       install disks you used to create your active OS/2
  73.                       system.  One file that is always required is SYSINSTX
  74.                       which is used to create the OS/2 BOOT record, OS2BOOT.
  75.                       The file SYSINSTX.COM is (so far) always found on the
  76.                       first Install disk.  If you are creating a BOOT Disk,
  77.                       then the files KEYBOARD.DCP, VTBL850.DCP, and the
  78.                       CONFIG.SYS file from the install disk are also required.
  79.                       These files (so far) are always found on the second
  80.                       install disk.
  81.  
  82.                       Normally BOOTOS2 will prompt you for the Install disks
  83.                       it needs.  However, if you installed OS/2 over a LAN
  84.                       or equivalent redirected source, you can use the SOURCE
  85.                       option to point to these redirected sources.  The value
  86.                       of SOURCE is usually a standard CID directory structure,
  87.                       as defined in "GG24-3780 : OS/2 V2.0 and V2.1 Remote
  88.                       Installation and Maintenance".
  89.  
  90.                       Alternatively, SOURCE can point to a single directory
  91.                       where all the required files are located.  This is the
  92.                       usual format OS/2 CSD remote installs where all the
  93.                       install disks are copied to a single directory.  You
  94.                       could alternatively create a single directory that
  95.                       contains only those files needed by BOOTOS2 and use the
  96.                       SOURCe option so users won't have to worry about install
  97.                       disks.
  98.  
  99.              TARGET=  By default, BOOTOS2 will install the BOOT system on a
  100.                       floppy disk in your A: drive.  You can use the TARGET=
  101.                       argument to specify an alternate Drive to install the
  102.                       BOOT system on.  This alternate drive can be another
  103.                       floppy or a Hard Disk Drive.  Any medium capable of
  104.                       being booted from can be a target.
  105.  
  106.                       Values for target are a single drive letter: A .. Z
  107.  
  108.              TYPE=PM  BOOTOS2 will install a BOOT System that will support
  109.                       PM Applications.  The BOOT System will be accessed as
  110.                       a single OS/2 Windowed Command Prompt.
  111.  
  112.             TYPE=WPS  BOOTOS2 will install a BOOT system that will support
  113.                       PM Applications.  The BOOT System will be accessed
  114.                       using the OS/2 WorkPlace Shell (WPS).
  115.  
  116.                  NLS  By Default, BOOTOS2 will get information regarding the
  117.                       NLS environment from the following CONFIG.SYS statements:
  118.  
  119.                       DEVINFO=KBD,xx,KEYBOARD.DCP     : Default xx  = US
  120.                       COUNTRY=xxx,COUNTRY.SYS         : Default xxx = 001
  121.                       CodePage=xxx                    : Default xxx = 850
  122.  
  123.                       If your environment requires different values for the
  124.                       above statements, you specify them via the NLS argument.
  125.                       Please note that you must specify all three values.
  126.  
  127.                       NOTE: The statement is only valid for a TYPE=PM or
  128.                             TYPE=WPS install.  For a minimal install (the
  129.                             default) the 'stripped' versions of the NLS
  130.                             modules, KEYBOARD.DCP and VTBL850.DCP, are
  131.                             used which do not support alternate values.
  132.  
  133.                2DISK  If creating a BOOT system where the target is a floppy
  134.                       disk drive, the 2DISK option allows you to spread the
  135.                       BOOT system across two disks, increasing the amount of
  136.                       space available for both required and optional files.
  137.  
  138.                       By default, if your system has a B: drive, BOOTOS2 will
  139.                       use that as the second drive.  If you don't have a B:
  140.                       drive then BOOTOS2 will use A: for both disks (in which
  141.                       case you'll have to swap disks during OS/2 IPL).
  142.  
  143.                       Alternatively, you can specify an alternative target
  144.                       drive for the second drive.  This is useful when you
  145.                       want to use a floppy drive other than B (for whatever
  146.                       reason).
  147.  
  148.                       Also, if you have a B: drive, but still want to create a
  149.                       2-Disk BOOT system using only the A: drive, you can
  150.                       specify 2DISK=A to override the default of using B.
  151.  
  152.                 REXX  If room allows, support for REXX will be installed.
  153.  
  154.                 HELP  BOOTOS2 will try and add basic OS/2 Help support.
  155.  
  156.                  VDM  Support for Virtual Dos Machines (VDMs) will added.
  157.  
  158.                       *NOTE* This option can not be used when the target
  159.                              drive is a floppy disk.
  160.  
  161.                       *NOTE* When VDM support is installed on a Minimal
  162.                              system (Text Only), to start a new VDM session
  163.                              press the Ctrl-D key combination.  This will
  164.                              invoke a new VDM session.
  165.  
  166.                SYSED  Add support for the OS/2 System Editor (E.EXE)
  167.  
  168.                SWAP=  For a TYPE=PM or TYPE=WPS install, the default value for
  169.                       the SWAPPATH is the ROOT directory of the target BOOT
  170.                       system.  You can use this option to place the Swap File in
  171.                       a different directory.
  172.  
  173.                TRACE  Use this option to create a Trace of the Install Process.
  174.                       A file called BOOTOS2.LOG will be created that will
  175.                       contain a complete record of the requested BOOT System
  176.                       Install process.  By default the LOG file will be created
  177.                       on the same physical directory the BOOTOS2.EXE program
  178.                       resides on.  You can optionally specify an alternate path
  179.                       for the LOG file; e.g. TRACE=drive:\path
  180.  
  181.               FORMAT  You can use this option to have BOOTOS2 force a certain
  182.                       type of Format (i.e. FAT, HPFS, or NONE) to the target
  183.                       drive.  This is usesefull for automated processes.
  184.  
  185.                QUIET  This will run BOOTOS2 such that no output is produced.
  186.                       This is also useful for automated processes.  You can
  187.                       use the TRACE option to maintain a record of the install.
  188.                       Please note that because BOOTOS2 can't prompt the user
  189.                       to   k about formating the target drive, if you don't
  190.                       explicitly specify the FORMAT option, FOAMRT:FAT will
  191.                       be assumed.
  192.  
  193.                The following 5 options can be used to force BOOTOS2 to assume
  194.                that the specified OS/2 v2.x version is the 'active' level.
  195.                Usually BOOTOS2 will determine this automatically by examining
  196.                the SYSLEVEL.OS2 file, so you shouldn't need to use these
  197.                options under normal circumstances.  However, there are times
  198.                when the SYSLEVEL.OS2 file can become corrupted, making it
  199.                impossible for BOOTOS2 to determine the active system level.
  200.                You can use these options to get around this problem.
  201.  
  202.                GA200  OS/2 2.00 GA
  203.                SP200  OS/2 2.00 SP
  204.                GA210  OS/2 2.10 GA
  205.                SP211  OS/2 2.11 CSD SP
  206.                MR211  OS/2 2.11 Manufacturers Refresh
  207.  
  208. You must run BOOTOS2 from an existing OS/2 V2 system.  The BOOTOS2 program
  209. will analyze your system and create a BOOT system that is specific for it.  For
  210. example it will determine if your system supports features such as HPFS or SCSI
  211. and add the appropriate support for it.  Because of this, a BOOT disk created
  212. for a specific workstation will not necessarily work correctly on a different
  213. workstation.
  214.  
  215. If you install the BOOT system on a Hard Disk Drive, you'll probably want to
  216. also install the OS/2 BOOT Manager and add the BOOT system to it.
  217. Please note that the BOOT system installed with this release of BOOTOS2 does
  218. not support Windows.  A future release of the program might do so
  219. if enough users want it (and I figure out how).
  220.  
  221. The file BOOT2X.ZIP contains the following files:
  222.  
  223.   BOOTOS2.EXE       * The OS/2 BOOT System Create Utilty for OS/2 V2.0
  224.   BOOTOS2.ABS       * Short Abstract descriping the Function of SE20BOOT
  225.   BOOTOS2.DOC       * Documentation for SE20BOOT
  226.   BOS2U20.INI       * User   INI file needed for OS/2 2.0
  227.   BOS2S20.INI       * System INI file needed for OS/2 2.0
  228.   BOS2U21.INI       * User   INI file needed for OS/2 2.0+SP and OS/2 2.1
  229.   BOS2S21.INI       * System INI file needed for OS/2 2.0+SP and OS/2 2.1
  230.   BOS2REXX.EXE      * Stub Module for REXX Support
  231.   BOS2SHL.EXE       * Protect Shell program for use instead of SYSINST1
  232.   LICENSE.TXT       * IBM License Agreement
  233.  
  234. Author:
  235.  
  236. Kennneth A. Kahn,  IBM Poughkeepsie N.Y.
  237.  
  238. CompuServe - 71333,2526
  239. Internet   - KENKAHN@VNET.IBM.COM
  240. IBM Mail   - USIB25P9 at IBMMAIL
  241.  
  242.  
  243. History:
  244.  
  245. 08/92 : (v1.00)
  246.  
  247. - Initial release
  248.  
  249. 03/93 : (V2.00)
  250.  
  251. - Fixed a problem where BOOTOS2 was not recognizing a Floppy Disk Drive as a
  252.   Removable medium if no Disk was in it when the program first started.  This
  253.   would cause BOOTOS2 to install the wrong BOOT System, resulting in various
  254.   errors.
  255.  
  256. - Fixed problem with FORMAT by making it run Synchronously so if it Fails, an
  257.   error code will be returned.
  258.  
  259. - Added support for NLS Statement
  260.  
  261. - When COPYing file, added more meaningful error messages
  262.  
  263. - Fixed problem running BOOTOS2 from a ROOT Directory
  264.  
  265. - The temporary directory where files from the install disks are copied is
  266.   changed from the directory where BOOTOS2.EXE is executed from to a new
  267.   subdirectory based off of it named BOS2TEMP  This will prevent BOOTOS2 from
  268.   overwriting and deleting system files when it is located on the \OS2
  269.   directory of the BOOT Drive.
  270.  
  271. - The INI files can now be located on your DPATH
  272.  
  273. - If the Target Drive is already formatted and contains data, the option to
  274.   run the Install without formating is given.
  275.  
  276. - Added special support for the Image Adapter/A
  277.  
  278. - All DLLs will be located via LIBPATH instead of looking automatically for it
  279.   in \OS2\DLL
  280.  
  281. - Changed TARGET= to allow for X or X:
  282.  
  283. - For a minimal install, a check will be made to see if there is enough room
  284.   left on the target drive to copy over extra files like CHKDSK, UHPFS and
  285.   OSO001.MSG
  286.  
  287. - Fixed problem where HPFS support was not added if the Target drive was
  288.   formatted for HPFS but the active system did not have HPFS support.
  289.  
  290. - Added support for 2-Disk BOOT System via 2DISK argument
  291.  
  292. - Added NLS support for FORMAT by querying system for the response character
  293.   to use: US default is 'Y'
  294.  
  295. - Added support for a BOOT system when active system is OS/2 2.0 with Service
  296.   Pack or OS/2 2.1
  297.  
  298. - Added support for REXX invocation argument
  299.  
  300. - Added support for ABIOS argument.  This allows a user to explicitly specify
  301.   that the workstation supports ABIOS.  This will allow the user to circumvent
  302.   the  problem where "RAM Loadable" MicroChannel machines were being diagnosed
  303.   as not supporting ABIOS; causing the wrong set of system files to be loaded.
  304.  
  305. - Changed external name to BOOTOS2
  306.  
  307. - Added support for the TRACE invocation option
  308.  
  309. - Added support for the SWAP= invocation argument
  310.  
  311. 05/93 : (V3.00)
  312.  
  313. - Updated BOS2U21 and BOS2S21 files to 2.1 GA levels
  314.  
  315. - Fixed 2DISK option.  It will no longer return RC=4 after trying
  316.   to format B.
  317.  
  318. - Added support for SVGA; Copy over \OS2\SVGADATA.PMI
  319.  
  320. - Added code to copy over BASEDEV= invocation arguments
  321.  
  322. - Added code to copy over HELPMGR.DLL if room allows
  323.  
  324. - Added 2.1 support for 8514 by updating BOS2U21.INI with the proper values
  325.   for PM_DISPLAYS.  This updating of BOS2U21 will be done for all display
  326.   types if necessary.
  327.  
  328. - Added support for HPFS386
  329.  
  330. - For a Disk Install, install sequence changed so the files SYSINST1 and
  331.   HARDERR are only copied if there is room.  This frees up room for BIO
  332.   files required by certain MicroChannel machines that could not fit
  333.   otherwise.
  334.  
  335.   *NOTE* If SYSINST1/HARDERR are not installed, then CAD will not work
  336.  
  337. - Enhanced install of BASEDEV drivers.  For a single 1.44M BOOT Disk, only
  338.   those BASEDEV drivers that are needed for accessing DASD (.ADD) are copied.
  339.   Otherwise, if room allows, all BASEDEV drivers will be copied.
  340.  
  341. - Removed copying of DTM.DLL for a TYPE=PM or TYPE=WPS install.  It wasn't
  342.   needed for anything as far as I could tell and at least one user complained
  343.   it wasn't installed on his base OS/2 system
  344.  
  345. - Support for the IBM IA/A is not working in this release.  I am trying to get
  346.   help with this from the IA/A development team, but it might take a while.  If
  347.   you have IA/A support installed on your active system when you run BOOTOS2,
  348.   you can try the following:
  349.  
  350.   * On the \OS2\DLL directory of your active OS/2 2.x system, look for a file
  351.     named DISPLAY.OLD; this is the DISPLAY.DLL that was active before you ran
  352.     the IA/A INSTALL program.  Copy this 'over' the DISPLAY.DLL that BOOTOS2
  353.     installed on the \OS2\DLL directory of your 'target' system.
  354.  
  355.   * In the CONFIG.SYS of your target system, look for the following statements:
  356.  
  357.     DEVICE=\OS2\XGARING0.SYS
  358.     DEVICE=\OS2\IAOS2RFS.SYS
  359.     SET VIDEO_DEVICES=VIO_yyy,VIO_IBMIAA
  360.     SET VIO_IBMIAA=DEVICE(BVHVGA,BVHIAA)
  361.     SET VIO_yyy=DEVICE(BVHVGA,BVHyyy)
  362.  
  363.   * Change these to:
  364.  
  365.     rem DEVICE=\OS2\XGARING0.SYS
  366.     rem DEVICE=\OS2\IAOS2RFS.SYS
  367.     SET VIDEO_DEVICES=VIO_yyy
  368.     rem SET VIO_IBMIAA=DEVICE(BVHVGA,BVHIAA)
  369.     SET VIO_yyy=DEVICE(BVHyyy)
  370.  
  371.   * Do this *BEFORE* you IPL your Target BOOTOS2 System
  372.  
  373. 03/94 : (V4.00)
  374.  
  375. - Enhanced the 2DISK option to work on a system with a single Disk Drive.
  376.  
  377. - Enhanced the TRACE option to accept an alternate PATH where BOOTOS2.LOG will
  378.   be created.
  379.  
  380. - For XGA support, all files on the XGA$DMQS directory will now be copied to
  381.   the Target Drive.
  382.  
  383. - Enhanced BASEDEV processing to search for target files via DPATH instead of
  384.   just on the \OS2 directory.
  385.  
  386. - Fixed support HPFS386 support; files HPFS200.386 and HFS.MSG are copied as
  387.   well as HPFS386.IFS.  For a minimal install, the BOOTSH.EXE OS/2 Shell program
  388.   will be copied and used as the PROTSHELL.
  389.  
  390. - For SVGA support, made copying of SVGADATA.PMI optional.  This is in case the
  391.   SVGA ON command was not yet run
  392.  
  393. - Mouse support will be added to a minimal BOOT System if room allows
  394.  
  395. - Added support for the OS/2 2.11 CSD SP and 2.11 Manfacturers Refresh
  396.  
  397. - Enhanced SOURCE= to allow for Service Pack (CSD) install by allowing it to
  398.   point to a single directory instead of a CID directory structure.
  399.  
  400. - Added HELP option to optionally add support for OS/2 Help
  401.   if room allows.  The files HPMGRMRI.DLL and HMHELP.HLP are
  402.   are copied, and a SET HELP= statement is added to the
  403.   CONFIG.SYS
  404.  
  405. - For a minimal system, BOOTOS2 will now use it's own SHELL program, BOOTSHL,
  406.   instead of SYSINST1.  Unlike SYSINST1, BOOTSHL program supports multiple
  407.   screen sessions (via Alt-Esc).  It also supports STARTUP.CMD
  408.  
  409. - Added support for VDMs via VDM option
  410.  
  411. - Added some new invocation arguments to allow for
  412.   unattended installs.
  413.  
  414.   FORMAT[:FAT]  = Automatically Format Target for FAT
  415.   FORMAT:HPFS   = Automatically Format Target for HPFS
  416.   FORMAT:NONE   = Automatically Skip the Target Format
  417.  
  418. - Added SYSED option to optionally add support for the
  419.   OS/2 System Editor (E.EXE)
  420.  
  421. - Added SYSINSTX as an optional install file
  422.  
  423. - Added optional target to 2DISK option (2DISK=x:)
  424.  
  425. - Added code to cleanup, and remove, BOS2TEMP when done
  426.  
  427. - Added QUIET argument to allow suppression of all output
  428.   to StdOUT
  429.  
  430. - Verified all cases where BOOTOS2 ends in error would
  431.   return a non-zero code
  432.  
  433. - Added Stacker Support.
  434.  
  435. - Removed COM.SYS as file that BOOTOS2 will install for
  436.   serial mouse support (not needed)
  437.  
  438. - Updated SOURCE option to look for either CID directory
  439.   structure or a single directory
  440.  
  441. - Added support for AOX upgrade.  If OEMXLAT.SYS is found
  442.   on active system, it will copied to target drive
  443.  
  444. 07/94 : (V5.00)
  445. - Fixed problem where if target disk was formated for HPFS
  446.   and HPFS386 is active, support for HPFS.IFS would be
  447.   installed instead of for HPFS386
  448.  
  449. - For a 2-Disk Install, the support files for HPFS and the
  450.   file CMD.EXE will be copied to the second target drive to
  451.   space on the first target drive.
  452.  
  453. - Added support for OS2fW 2.10 Ga and OS2fW 2.11 SP
  454.  
  455. - Added support for the OS/2 Performance Beta (v2.12)    
  456.  
  457. - Removed AOX support as that is only needed in a 16-bit 
  458.   environment (e.g. OS/2 v1.x).                          
  459.  
  460. - Fixed Stacker support to allow for STACKERI.SYS        
  461.  
  462. - As of LS 4.0 the file HPFS200.386 was folded into the  
  463.   HPFS386.IFS file.  Code added to recognize this and    
  464.   to not copy HPFS200.386 if appropriate.                
  465.